home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / apps2 / carcost4.lzx / cc4.txt < prev   
Text File  |  1993-03-26  |  7KB  |  200 lines
  1. Program CARCOST3.OPA
  2. Textfile CARCOST3.WRD (this file)
  3.  
  4. CarCost3.OPA
  5.  
  6. Version 3.0
  7. Carl Littlejohns (see Appendix 2)
  8.  
  9.  
  10. CarCost arose from the need for a simple to use utility that would allow me to
  11. quickly enter journey, fuel purchase details etc., and that would then allow
  12. me to get at the data in a useable way.
  13.  
  14. My favourite stats package happens to be public domain, and will accept comma
  15. delimited ascii, so that is the format I use when exporting the data.
  16.  
  17. You can peruse entries from CarCost without exporting the data.  The commonest
  18. thing I need to do is recall a half complete entry when a journey is complete.
  19. This is easy to do, and more powerful searches of all stored data are also
  20. possible.
  21.  
  22. Installation
  23.  
  24. The program should be installed in the \APP\ subdirectory, and will create
  25. it's datafile ( car.odb ) and any ASCII exported file ( carout.asc ) in the
  26. \OPD\ subdirectory.  The drive used is determined by the current default drive
  27. set up by {Psion}-G from the series 3 system screen.
  28.  
  29. Copy CarCost3.OPA to the /APP/ subdirectory of the Series 3 and then from the
  30. system screen select {Psion}-I and at the installation menu select CARCOST3
  31. for installation.
  32.  
  33. The new ICON should appear on screen.  When first run, the program looks for
  34. it's data file (car.odb) in the \OPD\ area.  If not found the ICON will have
  35. "CAR3" displayed below it.  If the file exists already, then "Car" appears
  36. below - as it will in ordinary use.
  37.  
  38. CarCost creates an empty data file when first run from the system screen.
  39.  
  40. IF YOU WISH TO USE THE DATAFILE FROM A PREVIOUS VERSION OF CARCOST YOU SHOULD
  41. COPY IT INTO THE \OPD\ AREA BEFORE RUNNING CARCOST2.
  42.  
  43. Use
  44.  
  45. The main command menu appears thus:
  46.  
  47.         CarCost v3.0
  48.         -----------------------   
  49.         FIND    last entry
  50.         ENTER FUEL purchase
  51.         DATA   PROCESSING
  52.         HELP   &  INFORMATION
  53.  
  54. The menu items are selected by highlighting the item and pressing ENTER.
  55.  
  56. The first two items, when highlighted give further options if the left or
  57. right arrow keys are pressed before ENTER.
  58.  
  59. FIND: LAST entry
  60. Selecting this recalls the last entry made (assuming the files have not been
  61. sorted subsequently) and allows it to be edited or added to.  ESC cancels the
  62. function, ENTER saves the amended record.
  63.  
  64. FIND: DATABASE entry
  65. This item displays a search dialog, which allows the display of records
  66. according to ONE of three types of search.
  67.  
  68. TYPE - only BUSINESS or only FUEL entries can be displayed etc.
  69.  
  70. Date - only records ON or AFTER the selected date will appear.
  71.  
  72. or
  73.  
  74. Text - only records containing the piece of text entered will be found. e.g.
  75. enter 'home' and pull in records of journeys to and from home.  Selecting this
  76. option and entering NO search text will recall ALL records.
  77.  
  78. ENTER: Fuel Purchase
  79. This item prompts for a date (but supplies TODAYs date by default- as appears
  80. on ALL entry screens in CarCost) a mileage reading (mileometer) the number of
  81. litres purchased and the amount spent.
  82.  
  83. ENTER: BUSINESS mileage
  84. This item prompts for date, start and end mileometer reading, and FROM and TWO
  85. strings for text of the journey details. 
  86.  
  87. ENTER: PERSONAL mileage
  88. As for business miles.
  89.  
  90. ENTER: SERVICE entry
  91. This item records date, mileage, which service it is, which garage and the
  92. cost incurred.
  93.  
  94. ENTER:Misc
  95. This item records miscellaneous expenditure on the care in a simialr format.
  96.  
  97. DATA PROCESSING
  98. This opton produces another dialog that 1. sorts the datafile in order of
  99. mileometer reading. 2. exports the data a comma delimited ascii.  The format
  100. of the file allows for importing the data into any package which accepts comma
  101. delimited files - spreadsheets, graphic packages and databases - as well as
  102. BASIC.  See appendix 1.
  103.  
  104. 3. deletes all items entered BEFORE a chosen date - by default this starts at
  105. 30days before TODAY. 4. If the datafile is stored on FLASH SSD this option
  106. will compress it to remove space from deleted records.
  107.  
  108. Deleting database records:
  109.  
  110. The main way of deleting records is to use the block delete option which is
  111. available from the DATA PROCESSING option.
  112.  
  113. In additiona individual records can be deleted in one of three ways.
  114.  
  115. 1.At the time of data entry, if instead of pressing ENTER, you press ESC then
  116. that record will NOT be stored as an entry.
  117.  
  118. 2.At the time of data entry, if you move the cursor up to the 'Entry Type'
  119. option, and then press the left or right arrow keys, the 'type' bar will
  120. change to display ** DELETE THIS ENTRY ** .  Pressing ENTER at this point
  121. saves and then immediately deletes the record.  Of course, the 'recall last
  122. entry' option produces an inaccurate result immediately afterwards, since the
  123. last record technically doesn't exist!
  124.  
  125. 3. To delete an existing record, use the search menu to locate the record,
  126. move to the 'Entry Type' bar as before, and using the left/right arrow keys
  127. set the entry to DELETE and press ENTER.  Pressing ESC in this instance
  128. PREVENTS the record from being deleted.
  129.  
  130.  
  131. Appendix 1
  132.  
  133. ASCII output file \opd\carout.asc format.
  134.  
  135. This is a text file, the first line of which consists of 8 headings, as
  136. inverted comma delimited strings separated by commas.
  137.  
  138. Each subsequent line consists of one record from the data file in the
  139. following order, depending on the type of entry:
  140.  
  141. 1st item: Entry type
  142. Stored as a single letter- F-fuel entry, B-business miles, P-personal miles,
  143. S-service, O-miscellaneous ('other')
  144.  
  145. 2nd item: Date
  146. Stored as a european date string:
  147. dd/mm/yy
  148.  
  149. 3rd item: MilesA
  150. This refers to the mileage at the time the record was entered (or the start
  151. mileage of a journey)
  152.  
  153. 4th item: MilesB
  154. This is the mileage at the end of the journey.
  155.  
  156. 5th item:From
  157. This is a 25 character text string -journey start, or for a service entry it
  158. is the particular service, or for a misc. item it is the first text item.
  159.  
  160. 6th item:To
  161. This is the end of journey text string, or for miscellaneous entries, the
  162. second text item.
  163.  
  164. 7th item
  165. This is a decimal number corresponding to litres of fuel purchased (if
  166. applicable, or just "")
  167.  
  168. 8th item (final)
  169. This is a decimal number corresponding to cost - fuel cost, service cost,
  170. misc. cost.
  171.  
  172. Empty items export as empty inverted commas e.g. "".
  173.  
  174.  
  175. NB When the sort option is run, it sorts the database on item 3, the first
  176. mileage.
  177.  
  178. Appendix 2
  179.  
  180. The author:
  181.  
  182. Carl Littlejohns   October 1992
  183. Email:csljohns@cix
  184. FidoNet 2:253/152
  185. Fax: 0745-812125
  186.  
  187. Appendix 3
  188.  
  189. Public Domain.
  190.  
  191. This program is in the public domain.  It may not be sold, or included with
  192. software that is being sold.
  193.  
  194. The concept of public domain originated from the educational establishments of
  195. the USA.  I have benefitted greatly from this initiative which I hope will be
  196. around for  a long time to come...the public domain I mean, not the USA...er
  197. that is...
  198.  
  199. Carl Littlejohns    December 1992
  200.